home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat2 / standard / cachectl.z / cachectl
Encoding:
Text File  |  1998-10-20  |  3.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. CCCCAAAACCCCHHHHEEEECCCCTTTTLLLL((((2222))))                                                        CCCCAAAACCCCHHHHEEEECCCCTTTTLLLL((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cachectl - mark pages cacheable or uncacheable
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ccccaaaacccchhhheeeeccccttttllll....hhhh>>>>
  13.  
  14.      iiiinnnntttt ccccaaaacccchhhheeeeccccttttllll ((((vvvvooooiiiidddd ****aaaaddddddddrrrr,,,, iiiinnnntttt nnnnbbbbyyyytttteeeessss,,,, iiiinnnntttt oooopppp))));;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The _c_a_c_h_e_c_t_l system call allows a process to make ranges of its address
  18.      space cacheable or uncacheable.  Initially, a process's entire address
  19.      space is cacheable.
  20.  
  21.      The _o_p parameter may be one of:
  22.  
  23.      CCCCAAAACCCCHHHHEEEEAAAABBBBLLLLEEEE        Make the indicated pages cacheable
  24.  
  25.      UUUUNNNNCCCCAAAACCCCHHHHEEEEAAAABBBBLLLLEEEE      Make the indicated pages uncacheable
  26.  
  27.      The CACHEABLE and UNCACHEABLE _o_p's affect the address range indicated by
  28.      _a_d_d_r and _n_b_y_t_e_s.  _a_d_d_r must be page aligned and nbytes must be a multiple
  29.      of the page size.
  30.  
  31.      Changing a page from UNCACHEABLE state to CACHEABLE state will cause both
  32.      the instruction and data caches to be flushed if necessary to avoid stale
  33.      cache information.
  34.  
  35.      On Power Indigo2, Indigo2 10000 and Power Challenge M systems, user
  36.      programs are not allowed uncached access to main memory, so requesting
  37.      this will fail with EINVAL.
  38.  
  39.      On systems with hardware coherent caches, _c_a_c_h_e_c_t_l will complete
  40.      successfully, but not actually allow memory to be accessed uncached.
  41.  
  42. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  43.      _c_a_c_h_e_c_t_l returns 0 when no errors are detected.  If errors are detected,
  44.      _c_a_c_h_e_c_t_l returns -1 with the error cause indicated in _e_r_r_n_o.
  45.  
  46. EEEERRRRRRRROOOORRRRSSSS
  47.      [EINVAL]         The _o_p parameter is not one of CACHEABLE or UNCACHEABLE,
  48.                       or is UNCACHEABLE on a Power Indigo2, Indigo2 10000 or
  49.                       Power Challenge M.
  50.  
  51.      [EINVAL]         The _a_d_d_r parameter is not page aligned, or _n_b_y_t_e_s is not
  52.                       a multiple of the page size.
  53.  
  54.      [EFAULT]         Some or all of the address range _a_d_d_r to (_a_d_d_r+_n_b_y_t_e_s-1)
  55.                       is not accessible.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCAAAACCCCHHHHEEEECCCCTTTTLLLL((((2222))))                                                        CCCCAAAACCCCHHHHEEEECCCCTTTTLLLL((((2222))))
  71.  
  72.  
  73.  
  74. SEE ALSO
  75.      cacheflush(2)
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.